<html>
<head><meta charset="utf-8"><title>Section reviews · t-compiler/wg-rustc-dev-guide · Zulip Chat Archive</title></head>
<h2>Stream: <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/index.html">t-compiler/wg-rustc-dev-guide</a></h2>
<h3>Topic: <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Section.20reviews.html">Section reviews</a></h3>

<hr>

<base href="https://rust-lang.zulipchat.com">

<head><link href="https://rust-lang.github.io/zulip_archive/style.css" rel="stylesheet"></head>

<a name="244689733"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Section%20reviews/near/244689733" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> rylev <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Section.20reviews.html#244689733">(Jul 02 2021 at 11:33)</a>:</h4>
<p>I'd like to suggest a possible mechanism for improving the dev guide: section reviews. </p>
<p>Some background: I'm trying to learn more about macro expanasion and name resolution. I read the sections on lexing/parsing and macro expansion, and I wrote down my impressions - a collection of thoughts on improvements, and things that didn't make sense to me. <a href="https://github.com/rust-lang/rustc-dev-guide/issues/1165">https://github.com/rust-lang/rustc-dev-guide/issues/1165</a></p>
<p>Perhaps others could provide feedback on sections. Often these impressions are left unreported because each on an individual level don't really merit an issue. Do we think this could be a useful mechanism for trying to improve sections? If so, we could provide a generic template and encourage anyone who needs to read a section to fill out the template.</p>



<a name="244693301"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Section%20reviews/near/244693301" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> mw <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Section.20reviews.html#244693301">(Jul 02 2021 at 12:13)</a>:</h4>
<p>That sounds like a great idea!</p>



<a name="244807698"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Section%20reviews/near/244807698" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Santiago Pastorino <a href="https://rust-lang.github.io/zulip_archive/stream/196385-t-compiler/wg-rustc-dev-guide/topic/Section.20reviews.html#244807698">(Jul 03 2021 at 14:14)</a>:</h4>
<p><span class="user-mention silent" data-user-id="224872">rylev</span> <a href="#narrow/stream/196385-t-compiler.2Fwg-rustc-dev-guide/topic/Section.20reviews/near/244689733">said</a>:</p>
<blockquote>
<p>I'd like to suggest a possible mechanism for improving the dev guide: section reviews. </p>
<p>Some background: I'm trying to learn more about macro expanasion and name resolution. I read the sections on lexing/parsing and macro expansion, and I wrote down my impressions - a collection of thoughts on improvements, and things that didn't make sense to me. <a href="https://github.com/rust-lang/rustc-dev-guide/issues/1165">https://github.com/rust-lang/rustc-dev-guide/issues/1165</a></p>
<p>Perhaps others could provide feedback on sections. Often these impressions are left unreported because each on an individual level don't really merit an issue. Do we think this could be a useful mechanism for trying to improve sections? If so, we could provide a generic template and encourage anyone who needs to read a section to fill out the template.</p>
</blockquote>
<p>This is a great idea <span aria-label="+1" class="emoji emoji-1f44d" role="img" title="+1">:+1:</span></p>



<hr><p>Last updated: Aug 07 2021 at 22:04 UTC</p>
</html>